home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / atelnt.zip / ATELNET.DOC < prev    next >
Text File  |  1993-03-13  |  18KB  |  513 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                       ATELNET: AN APPC REMOTE TERMINAL FOR OS/2
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                                                   June 10, 1992
  18.  
  19.  
  20.                                                              Peter J. Schwaller
  21.  
  22.  
  23.                                                                 IBM Corporation
  24.                                                          APPC Market Enablement
  25.                                                    Department E42, Building 673
  26.                                  Research Triangle Park, North Carolina   27709
  27.                                  ----------------------------------------------
  28.                                           Internet:     pjs@ralvm6.vnet.ibm.com
  29.                                                         CompuServe:   76711,371
  30.                                                     IBM VNET:     PJS at RALVM6
  31.                                                    Phone:        (919) 254-4376
  32.                                                        IBM Tie-line: 8-444-4376
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.   Abstract
  42.  
  43.  
  44.  
  45.  
  46.  
  47.   This paper describes how to use and configure an an APPC application program
  48.   for OS/2 Extended Edition or Extended Services.  The application, ATELNET,
  49.   provides remote terminal capability for OS/2, enabling you to log on to a
  50.   remote OS/2 workstation and execute programs on that workstation in a full-
  51.   screen session.
  52.  
  53.   ATELNET is an extended APPC application, as opposed to many widely-available
  54.   APPC samples that do little more than transfer files.  You can use ATELNET to
  55.   control multiple full-screen windows on another workstation.  You can also
  56.   use it to start more than one full-screen application on either one work-
  57.   station or different workstations.
  58.  
  59.   ATELNET was developed to provide more useful utilities for APPC.  It also
  60.   helps demonstrate that applications for APPC can be more powerful and perform
  61.   better than those for competitive protocols.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.   1.0  ATELNET: An APPC Remote Terminal for OS/2
  83.  
  84.  
  85.  
  86.  
  87.  
  88.   1.1  What is ATELNET?
  89.  
  90.   ATELNET is an APPC remote terminal modeled after TCP/IP's TELNET program.
  91.   TELNET is generally provided free of charge when you purchase a TCP/IP imple-
  92.   mentation.  Using ATELNET, you can control a window on a remote workstation.
  93.   Users on both workstations can type into the same window at the same time.
  94.   So, when I start a session to a remote workstation, a full-screen session
  95.   appears on that workstation.  You can switch to it, watch what I type, and
  96.   type in your own things, if you like.  Anything that appears on my screen
  97.   shows up on your screen, also.  For example, I can type DIR and you can press
  98.   Enter.
  99.  
  100.   For example, when Tim starts a session to Steve's workstation, Steve sees a
  101.   full-screen session appear on his workstation.  He can switch to that
  102.   session, watch what Tim types, or type in commands himself.  Any message or
  103.   command that appears on Tim's screen will also appear on Steve's screen.
  104.  
  105.  
  106.   1.2  Uses for ATELNET
  107.  
  108.   To date ATELNET has been used to:
  109.  
  110.   o   Run existing applications remotely that were not designed as cooperative
  111.       processing applications
  112.  
  113.   o   Manage remote workstation configurations
  114.  
  115.   o   Teach remote users how to run certain OS/2 programs.
  116.  
  117.   In general, most existing applications are not designed for cooperative proc-
  118.   essing.  For example, it is not possible to run remotely the OS/2 PSTAT
  119.   command to find out which OS/2 processes are running on a remote workstation.
  120.   With ATELNET, you can log on to that workstation and run PSTAT.  Similarly,
  121.   you can run full-screen text editors on a remote workstation.  For instance,
  122.   using Extended Services or Networking Services/2, you can use ATELNET to
  123.   connect to someone else's workstation, change their node definitions (.NDF)
  124.   file and then change their running APPC configuration.  If an APPC trans-
  125.   action program (TP) definition had to be added to all the workstations in a
  126.   network, I could easily do that as an administrator.
  127.  
  128.   ATELNET is also useful as a teaching tool.  Using ATELNET, you can show new
  129.   users how to perform some function even though they may be located at a
  130.   remote workstation.  You can bring up a full-screen session for new users,
  131.   and they can watch you demonstrate the use of a function.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.   2.0  A User's Guide to ATELNET
  141.  
  142.  
  143.  
  144.  
  145.  
  146.   ATELNET is invoked with only one parameter, the partner LU alias (or fully
  147.   qualified partner LU name) of an LU on the target workstation.  After you
  148.   invoke ATELNET, the conversations will be established and you will be shown
  149.   an OS/2 command prompt that has been created on the target workstation.
  150.  
  151.  
  152.   2.1  Starting ATELNET
  153.  
  154.     To start ATELNET, enter the following command:
  155.             ATELNET destination [flags]
  156.  
  157.     A destination is either the partner LU alias or the fully qualified
  158.     LU name of an LU on the target workstation.  The destination is
  159.     used as a fully qualified LU name if it contains a period.  A partner LU
  160.     alias may be 1 to 8 characters.  A fully qualified LU name consists of
  161.     a 1 to 8 character netid and a 1 to 8 character LU name separated by a
  162.     period (e.g., "NETID.LUNAME").
  163.  
  164.     Flags:
  165.             -u userid       (up to 10 characters)
  166.             -p password     (up to 10 characters)
  167.                     You will be prompted for a userid and password if they
  168.                     are needed.  If only a userid is specified, you will be
  169.                     prompted for the password.
  170.             -m mode_name    (up to 8 characters, default is "#INTER")
  171.  
  172.     After you enter this command, ATELNET establishes the conversations.
  173.  
  174.  
  175.   2.2  Exiting ATELNET
  176.  
  177.   To end ATELNET, type "EXIT" at the OS/2 command prompt at the controlling
  178.   workstation.
  179.  
  180.  
  181.   2.3  Common Problems
  182.  
  183.   If ATELNET hangs while establishing its conversations, ATELNETD on the target
  184.   workstation may be unable to successfully ALLOCATE the second session.  Check
  185.   the target workstation and make sure that the transaction program is defined
  186.   as FULL_SCREEN and that the ATNSPY.DLL file is in a subdirectory that is on
  187.   the LIBPATH.
  188.  
  189.   If another error occurs, use the Extended Services or Networking Services/2
  190.   trace facility or CMTRACE to capture a trace of the APPC API.  If you cannot
  191.   resolve/identify the problem, you may send the trace to me.
  192.  
  193.   Some common problems include:
  194.  
  195.   o   Incorrect TP program type
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.       SYMPTOM                                 ATELNET establishes the sessions
  205.                                               then immediately closes them.
  206.                                               ATELNETD changes the Communi-
  207.                                               cations Manager icon.
  208.  
  209.       EXPLANATION/RESPONSE                    The ATELNETD TP definition speci-
  210.                                               fies the program type as BACK-
  211.                                               GROUND.  The program type must be
  212.                                               FULL_SCREEN.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.   3.0  Configuring ATELNET For Your Network
  222.  
  223.  
  224.  
  225.  
  226.  
  227.   This section describes how to configure ATELNET, both with and without
  228.   Extended Services or Networking Services/2.
  229.  
  230.  
  231.   3.1  Configuring ATELNET Under Extended Services or Networking Services/2
  232.  
  233.   Use this section as a guide to configure Extended Services or Networking
  234.   Services/2 through SNA Configuration Management panels.  You can also use the
  235.   supplied ATELNET.NDF file as a template for editing your working node defi-
  236.   nitions file.
  237.  
  238.  
  239.   3.1.1  Configuring ATELNET On the Controlling Workstation
  240.  
  241.   To more easily identify the target workstation, define a partner LU alias.
  242.   The partner LU alias is simply another name you can use to specify the
  243.   target, rather than using the fully qualified partner LU name every time you
  244.   want to connect to the target.
  245.  
  246.     DEFINE_PARTNER_LU
  247.             FQ_PARTNER_LU_NAME(NETID.PARTNER)     /* change this */
  248.             PARTNER_LU_ALIAS(TARGET)
  249.             MAX_MC_LL_SEND_SIZE(32767)
  250.             CONV_SECURITY_VERIFICATION(NO)
  251.             PARALLEL_SESSION_SUPPORT(YES);
  252.  
  253.   If you are running Extended Services or Networking Services/2, ATELNET itself
  254.   defines the TP for the second conversation.  However, if you are running OS/2
  255.   EE 1.2 or 1.3 without Extended Services or Networking Services/2, you must
  256.   define the TP for the second conversation.
  257.  
  258.   You must also tell APPC how to find the target workstation.  You must either:
  259.  
  260.   o   Configure a link directly to the target workstation
  261.  
  262.         DEFINE_LOGICAL_LINK
  263.                LINK_NAME(TARGET)
  264.                ADJACENT_NODE_TYPE(LEARN)
  265.                FQ_ADJACENT_CP_NAME(NETID.PARTNER)    /* change this */
  266.                PREFERRED_NN_SERVER(NO)
  267.                DLC_NAME(IBMTRNET)
  268.                ADAPTER_NUMBER(0)
  269.                DESTINATION_ADDRESS(X'400000000001') /* change this */
  270.                CP_CP_SESSION_SUPPORT(YES)
  271.                ACTIVATE_AT_STARTUP(NO);
  272.  
  273.       Change the "NETID.PARTNER" name and the "DESTINATION_ADDRESS" field to
  274.       the control point name and LAN address of the target workstation.
  275.  
  276.   o   Configure a link to a network node and let the network node find the
  277.       target workstation.
  278.  
  279.       Both the controlling and target workstations should have links to network
  280.       nodes in the same network (i.e., identical netids).  If the workstations
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.       connect to different network nodes, the network nodes must have a path on
  288.       which they can establish a connection.  One recommendation is to define a
  289.       link from the controlling and target workstations to the same network
  290.       node.
  291.  
  292.         DEFINE_LOGICAL_LINK
  293.                LINK_NAME(MYNN)
  294.                ADJACENT_NODE_TYPE(LEARN)
  295.                FQ_ADJACENT_CP_NAME(NETID.NN)        /* change this */
  296.                PREFERRED_NN_SERVER(YES)
  297.                DLC_NAME(IBMTRNET)
  298.                ADAPTER_NUMBER(0)
  299.                DESTINATION_ADDRESS(X'400000000002') /* change this */
  300.                CP_CP_SESSION_SUPPORT(YES)
  301.                ACTIVATE_AT_STARTUP(NO);
  302.  
  303.       Change the "NETID.NN" name and the "DESTINATION_ADDRESS" field to the
  304.       control point name and LAN address of your network node server.
  305.  
  306.  
  307.   3.1.2  Configuring ATELNETD On the Target Workstation
  308.  
  309.   Configure a transaction program definition that the attach manager can use to
  310.   start the ATELNETD process.  Following is a sample verb from a node defi-
  311.   nitions file:
  312.  
  313.     DEFINE_TP
  314.             TP_NAME(ATELNETD)
  315.             FILESPEC(d:\work\atelnet\atelnetd.exe) /* change this */
  316.             CONVERSATION_TYPE(EITHER)
  317.             CONV_SECURITY_RQD(NO)
  318.             SYNC_LEVEL(CONFIRM)
  319.             TP_OPERATION(NONQUEUED_AM_STARTED)
  320.             PROGRAM_TYPE(FULL_SCREEN);
  321.  
  322.   Change the FILESPEC field to specify the path where you installed the
  323.   ATELNETD.EXE program.
  324.  
  325.   To avoid conflicts between the definitions for ATELNETD and other programs
  326.   which may be using the default TP support, configure the TP explicitly.  Do
  327.   not use the default TP capability of Extended Services or Networking
  328.   Services/2.
  329.  
  330.   If you do not specify IMPLICIT_INBOUND_PLU_SUPPORT(YES) on your
  331.   DEFINE_DEFAULTS verb you must specify a DEFINE_PARTNER_LU for each partner
  332.   that will be connecting to the target workstation.  This will lead to addi-
  333.   tional configuration for every partner LU and is not recommended.
  334.  
  335.   You do not need to define a local LU with Extended Services or Networking
  336.   Services/2, since you can use the control point LU which is already config-
  337.   ured (it is a required definition).
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.   3.1.3  Enabling Security with ATELNET
  347.  
  348.   To use security with ATELNET, change the CONV_SECURITY_RQD parameter on the
  349.   "ATELNETD" DEFINE_TP verb to CONV_SECURITY_RQD(yes).  This parameter tells
  350.   Extended Services or Networking Services/2 that a userid and password are
  351.   required to start this transaction program.  NS/2 compares the userid and
  352.   password with the ones that you supplied on the Extended Services or Net-
  353.   working Services/2 "Configuration Management" screens within the "Advanced
  354.   SNA" configuration options.
  355.  
  356.  
  357.   3.2  Configuring ATELNET without Networking Services/2 or Extended Services
  358.  
  359.   Use the following steps as a guide to configure the Communications Manager.
  360.   You can use the ATELNET.CFG file supplied with the ATELNET executables and
  361.   tailor it to your needs.
  362.  
  363.     Configuring ATELNET on OS/2 without
  364.     Extended Services or Networking Services/2.
  365.  
  366.     Change all names in parenthesis to fit your environment.
  367.  
  368.     These instructions assume that you are using token ring as your
  369.     DLC.  Configure both the controlling and target workstations.
  370.  
  371.     Before you start, you need to know:
  372.        the fully qualified network name
  373.        the token ring address of the workstation you will connect to
  374.  
  375.  
  376.     SNA Base
  377.             change
  378.                     PU name - (CPNAME)
  379.                             must be unique in the network
  380.                     Network Name (NETID)
  381.                     set auto-activate to YES
  382.                     ENTER
  383.  
  384.     DLC profiles
  385.             token ring
  386.             adapter 0 create/change
  387.                     load dlc - YES
  388.                     link stations - (number of machines you will connect to)
  389.                             you may have to increase the number of link
  390.                             stations defined in LAN Feature Profiles
  391.                     free unused link - NO
  392.                     congestion tolerance - 100
  393.                     max RU size - 4096
  394.                             the transmit buffer size in LAN Feature Profiles
  395.                             must be 124 larger than this value (4120).  Depending
  396.                             upon your token ring card, you may have to lower
  397.                             these values.
  398.                     send window count - 4
  399.                     recv window count - 4
  400.                     C&SM LAN id - pick something
  401.                     ENTER (everything else can default)
  402.  
  403.     LU Profiles (do this only if you don't have a default LU defined)
  404.             create CPNAME
  405.                     LU name - (CPNAME)
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                     default LU - YES
  413.                     NAU address - 00
  414.                     LU session limit - 255
  415.                     Max TPs - 0
  416.                     ENTER
  417.  
  418.     Skip down to:
  419.     Transmission Service mode profiles
  420.             create #INTER
  421.                     comment - Interactive mode
  422.                     min RU size - 256
  423.                     max RU size - 16384
  424.                     receive pacing limit - 8
  425.                     session limit - 8
  426.                     ENTER
  427.  
  428.     Initial Session Limit profiles
  429.             create INIT400
  430.                     min conwinners source - 4
  431.                     min conwinners target - 0
  432.                     num autoactive - 0
  433.                     ENTER
  434.  
  435.     go back up to:
  436.     Partner LU profiles
  437.             create (TARGET)
  438.                     fully qualified PLU name - (NETID).(TARGET)
  439.                     LU alias - (CPNAME)
  440.                     PLU session limit - 8
  441.                     Conv Security - Yes or No (easiest to configure is No)
  442.                     DLC type - token ring
  443.                     ENTER
  444.                     type the destination address of the TARGET machine
  445.                     ENTER
  446.                     select ADD
  447.                             mode name - #INTER
  448.                             sess lim  - INIT400
  449.                             ENTER
  450.                     select END
  451.  
  452.     Remotely Attachable transaction program profiles
  453.             create ATELNETD
  454.                     comment - ATELNET server
  455.                     TP filespec - type in the full path of ATELNETD.EXE
  456.                     sync level - Either
  457.                     conv type  - Either
  458.                     Conv Security - Yes or No (easiest to configure is No)
  459.                     TP operation - non queued AM started
  460.                     TP name - ATELNETD
  461.                             Important: type the TP name in ALL CAPS
  462.                     program type - Full Screen
  463.  
  464.     Remotely Attachable transaction program profiles
  465.             create ATELNET2
  466.                     comment - ATELNET second conversation
  467.                     TP filespec - type the full path of ATELNET.EXE
  468.                     sync level - Either
  469.                     conv type  - Either
  470.                     Conv Security - No
  471.                     TP operation - queued operator started
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                     TP name - ATELNET.RECEIVER
  479.                             Important: type the TP name in ALL CAPS
  480.                     ENTER (accept defaults)
  481.  
  482.     NOTE: If you selected YES for conversation security, fill out a
  483.     conversation security profile.
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.   4.0  Acknowledgments
  493.  
  494.  
  495.  
  496.  
  497.  
  498.   I appreciate the help of my IBM associates in writing and testing this appli-
  499.   cation, and in writing and reviewing this paper (listed below alphabet-
  500.   ically):
  501.  
  502.   o   Marc Fiammante
  503.   o   Steve Joyce
  504.   o   Susan Schulken
  505.   o   John Q. Walker
  506.   o   Mike Wamboldt
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.